home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1992 June: ROMin Holiday / ADC Developer CD (1992-06) (''ROMin Holiday'')_iso / Developer Connection - 06-1992.iso / Development Platforms / Apple II / Essentials / Technical.Notes / PDOS / TN.PDOS.019 < prev    next >
Encoding:
Text File  |  1988-12-15  |  3.2 KB  |  63 lines  |  [TEXT/pdos]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. ProDOS 8
  8. #19:    File Auxiliary Type Assignment
  9.  
  10. Revised by:    Matt Deatherage                                  November 1988
  11. Written by:    Matt Deatherage                                       May 1988
  12.  
  13. This Technical Note describes file auxiliary type assignments.
  14. _____________________________________________________________________________
  15.  
  16. The information in a ProDOS file auxiliary type field depends upon its primary 
  17. file type.  For example, the auxiliary type field for a text file (TXT, $04) 
  18. is defined as the record length of the file if it is a random-access file, or 
  19. zero if it is a sequential file.  The auxiliary type field for an 
  20. AppleWorks(TM) file contains information about the case of letters in the 
  21. filename (see Apple II File Type Notes, File Types $19, $1A, and $1B).  The 
  22. auxiliary type field for a binary file (BIN, $06) contains the loading address 
  23. of the file, if one exists.
  24.  
  25. Auxiliary types are now used to extend the limit of 256 file types in ProDOS.  
  26. Specific auxiliary types can be assigned to generic application file types.  
  27. For example, if you need a file type for your word-processing program, Apple 
  28. might assign you an auxiliary type for the generic file type of Apple II word 
  29. processor file, if it is appropriate.
  30.  
  31. An application can determine if a given file belongs to it by checking the 
  32. file type and the auxiliary type in the directory entry.  Other programming 
  33. considerations include the following:
  34.  
  35. 1.    If your program displays auxiliary type information, it should 
  36.       include all auxiliary types, not just selected ones.  Try to 
  37.       display the auxiliary type information stored in the directory 
  38.       entry, just as you would display hex codes for file types for 
  39.       which you do not have a more descriptive message to display.
  40. 2.    Programs should not store information in an undefined auxiliary 
  41.       type field.  Storing the record length in a text file is fine, and 
  42.       it is even encouraged, but storing the number of words in a text 
  43.       file in that text file's auxiliary type field might cause problems 
  44.       for those programs which expect to find a record length there.  
  45.       Similarly, storing data in the auxiliary type field will cause 
  46.       problems if your data matches an auxiliary type which is assigned.  
  47.       To avoid these problems, only store defined items in a file's 
  48.       auxiliary type field.  If you do not know of a definition for a 
  49.       particular file type's associated auxiliary type, do not store 
  50.       anything in its field.
  51.  
  52. To request a file type and auxiliary type, please send Apple II Developer 
  53. Technical Support a description of your proposed file format, along with a 
  54. justification for not using existing file and auxiliary types.  We will 
  55. publish this information publicly, unless you specifically prohibit it, since 
  56. we feel doing so enables the exchange of data for those applications who 
  57. choose to support other file formats.
  58.  
  59.  
  60. Further Reference
  61. o    ProDOS 8 Technical Reference Manual
  62. o    ProDOS 16 Technical Reference
  63.